home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 September / EnigmA AMIGA RUN 30 (1998)(G.R. Edizioni)(IT)[!][issue 1998-09].iso / recent / finnpe1.rea < prev    next >
Text File  |  1998-07-27  |  6KB  |  158 lines
  1. Short:    V0.44, a mpega.library frontend w/ cyclic buffering
  2. Author:   tumu@kempele.fi (Tuomas Lukinmaa)
  3. Uploader: tumu@kempele.fi (Tuomas Lukinmaa)
  4. Version:  0.44
  5. Type:     mus/play
  6. Requires: mus/misc/ahiusr.lha, util/libs/mpega_library.lha
  7. Requires: dev/c/AsyncIO.lha, KS 39+
  8.  
  9. Introduction and legal mush:
  10. ----------------------------
  11.  
  12. Finnpeg is an assembly written frontend for mpega.library using
  13. cyclic buffering, asyncio.library and AHI audio system.
  14. Finnpeg uses the device-interface in AHI. Look notes section below.
  15.  
  16. Finnpeg is a freeware product.
  17.  
  18. Finnpeg is Copyrighted © 1998 by Tuomas Lukinmaa. All rights reserved.
  19.  
  20. mpega.library is Copyrighted © Stephane Tavenard.
  21. AHI audio system is Copyrighted © by Martin Blom.
  22. AsyncIO library is Copyrighted © by Magnus Holmgren and Martin Taillefer.
  23. All rights reserved by their respective authors.
  24.  
  25.           THERE IS   NO  WARRANTY  FOR  THE  PROGRAMS,  TO  THE  EXTENT
  26.        PERMITTED  BY  APPLICABLE  LAW.  EXCEPT WHEN OTHERWISE STATED IN
  27.        WRITING  THE  COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
  28.        PROGRAMS  "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  29.        OR   IMPLIED,   INCLUDING,  BUT  NOT  LIMITED  TO,  THE  IMPLIED
  30.        WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A PARTICULAR
  31.        PURPOSE.   THE  ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
  32.        THE  PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE,
  33.        YOU  ASSUME  THE  COST  OF  ALL  NECESSARY  SERVICING, REPAIR OR
  34.        CORRECTION.
  35.  
  36.           IN NO  EVENT  UNLESS  REQUIRED BY APPLICABLE LAW OR AGREED TO
  37.        IN  WRITING  WILL  ANY  COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO
  38.        MAY  REDISTRIBUTE  THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO
  39.        YOU  FOR  DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  40.        CONSEQUENTIAL  DAMAGES  ARISING  OUT  OF THE USE OR INABILITY TO
  41.        USE  THE  PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  42.        DATA  BEING  RENDERED  INACCURATE  OR LOSSES SUSTAINED BY YOU OR
  43.        THIRD  PARTIES  OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY
  44.        OTHER  PROGRAMS),  EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN
  45.        ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  46.  
  47. Usage:
  48. ------
  49.  
  50. NAME/A,DIV=DIVISOR/N,QTY=QUALITY/N,MONO/S,UNIT/N/K,BUF=BUFFERS/N,
  51. FPB=FRAMESPERBUFFER/N,IOBUF=IOBUFFERS/N
  52.  
  53. NAME is abbreviation for filename to be played.
  54. No defaults here. =)
  55.  
  56. DIV or DIVISOR is divisor value given to mpega.library which is one of
  57. the following: 1=play with full sampling rate, 2=play with half sampling
  58. rate and 4=play with quarter sampling rate.
  59. Default is playing with full sampling rate.
  60.  
  61. Examples: You have a layer 3-file with sampling rate of 44100 khz and you
  62. give DIV=2 parameter to finnpeg, so finnpeg plays it with 22050 khz.
  63. You have a layer 3-file with sampling rate of 22050 khz and you
  64. give DIV=2 parameter to finnpeg, so finnpeg plays it with 11025 khz.
  65.  
  66. QTY or QUALITY is quality value gigen to mpega.library. Ranges from
  67. 0 (worst) to 2 (best).
  68. Default is best quality.
  69.  
  70. MONO activates force mono switch in mpega.library which causes it
  71. to decode stream mono (only left channel decoded).
  72. finnpeg also plays the stream with mono from both speakers.
  73. Default is to decode and play in stereo.
  74.  
  75. UNIT is an AHI option to give the unit number which to open. In theory
  76. you could play upto 4 streams at the same time (if your Amiga has
  77. CPU power). =) Ranges from 0 (default) to 3.
  78.  
  79. BUF or BUFFERS specify how many cyclic buffer slots to reserve.
  80. BUFFERS is multiplied with FRAMESPERBUFFER value.
  81. Default is 16.
  82.  
  83. FPB or FRAMESPERBUFFER specify how many mpega.library frame buffers is
  84. played in one go. One buffer is 1152 words.
  85. Default is 8.
  86. Total memory usage formula is in bytes:
  87.  
  88.     for tables: BUFFERS*8*FPB+BUFFERS*4
  89.     for buffers: BUFFERS*2*(1152*2*FPB)
  90.  
  91. IOBUF or IOBUFFERS is an AsyncIO library option which specifies how many
  92. kilobytes to use in IO buffers. AsyncIO divides this value in half to
  93. make use of double buffered reads.
  94.  
  95. Examples:
  96.  
  97. Plays stream with DIV=2, QUALITY=1 and MONO. Also plays 16 frames in one go.
  98. I use these options playing streams with my machine which is 030/50.
  99. finnpeg "CD0:mp3/Windows95 Sucks.mp3" 2 1 mono fpb=16
  100.  
  101. Plays stream with DIV=2, QUALITY=2 and STEREO. (suitable for 040s)
  102. finnpeg "CD0:mp3/Queen - Bohemian Rhapsody" 2 2
  103.  
  104. Notes:
  105. ------
  106. AHI's 8 bit modes seem to cause lot of background static because of
  107. mixing 16 bit audio data to 8 bits. Use 14 bit or better modes for
  108. best quality.
  109.  
  110. Remember to set the channels slider at least to 2 in AHI settings
  111. if playing in stereo, otherwise audio will loop strangely. It is a
  112. restriction caused by AHI. 
  113.  
  114. If playing streams you'll hear lot of clicks and pops (or similar),
  115. try to give FPB-parameter with value greater than 8.
  116.  
  117. There maybe a bug in UNIT allocation in AHI because opening
  118. ahi.device with different UNIT-number when playing a stream seems to
  119. return a error. Maybe this is only related to using paula-driver.
  120. Someone owning an audio card could try to play many streams at same time
  121. to see if this is only a problem with paula-driver.
  122.  
  123. When playing in stereo and your machine is heavily loaded, the left
  124. and right channels may go out of sync (probably happens when using very
  125. large FPB values). This is because there is no way (atleast I don't know
  126. it) in AHI's device-interface to play two or more channels in sync.
  127.  
  128. Todo list:
  129. ----------
  130. -Loading full stream in memory before playing.
  131. -GUI with support for WinAMP skins and equalizators.
  132. -audio.device support (needs own mixing routines).
  133. -Option to use normal io.
  134. -List files.
  135.  
  136. Hi's to:
  137. --------
  138. People in IRCnet channel #AmigaFIN.
  139. Stefane Tavenard for making mpega.library. Keep doing optimizations! =)
  140. Martin Blom for making AHI. Pity I don't have an audio card. =(
  141. All Amiga-users who are using this frontend.
  142.  
  143. Enjoy even faster mpeg audio. =)
  144.  
  145. Author's contact information:
  146. -----------------------------
  147. For bugreports, gifts and other stuff (excluding trading copyrighted
  148. mpeg-files), use one of following addresses:
  149.  
  150.     Snail-mail:
  151.  
  152.     Tuomas Lukinmaa
  153.     Einarintie 27
  154.     FI-90440 KEMPELE
  155.     Finland, EU
  156.  
  157.     E-mail: tumu@kempele.fi (preferred)
  158.